home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / ra / sm4rav10.zip / SM4RA.DOC < prev    next >
Text File  |  1996-02-21  |  9KB  |  138 lines
  1.  
  2.  
  3.               ███████╗ ███╗   ███╗ ██╗  ██╗ ██████╗   █████╗
  4.               ██╔════╝ ████╗ ████║ ██║  ██║ ██╔══██╗ ██╔══██╗
  5.               ███████╗ ██╔████╔██║ ███████║ ██████╔╝ ███████║
  6.               ╚════██║ ██║╚██╔╝██║ ╚════██║ ██╔══██╗ ██╔══██║
  7.               ███████║ ██║ ╚═╝ ██║      ██║ ██║  ██║ ██║  ██║
  8.               ╚══════╝ ╚═╝     ╚═╝      ╚═╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝
  9.           ───────────────────────────────────────────────────────
  10.           SendMessage v1.0 for RemoteAccess v2.xx by Joe Hornback
  11.                    Tornado Alley BBS @FidoNet 1:19/57
  12.  
  13. ┌───────────────────────────────────────────────────────────────────────────┐
  14. │ ▒▒ What is it? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  15. └───────────────────────────────────────────────────────────────────────────┘
  16.  SM4RA is a little program that allows the SysOp to send a message to a user
  17.  currently online on any of nodes 1-3 from another multitasking window.
  18.  
  19. ┌──────────────────────────────────────────────────────────────────────────┐
  20. │ ▒▒ Legal Stuff ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  21. └───────────────────────────────────────────────────────────────────────────┘
  22.  SM4RA is NetMailWare.  If you like this program and use it, please send me
  23.  routed OR crash netmail.  Bug reports, suggestions, or cosmetic critiques
  24.  are always welcome as well!  SM4RA has been tested and successfully run
  25.  under DesQview, W4WG3.11, OS/2 Warp, and Win95.  SM4RA is promised to do
  26.  absolutely NOTHING except take up hard drive space.  The author(s) of this
  27.  program take NO responsibilities and will NOT be held accountable for it's
  28.  actions!
  29.  
  30. ┌───────────────────────────────────────────────────────────────────────────┐
  31. │ ▒▒ Files Within This Archive ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  32. └───────────────────────────────────────────────────────────────────────────┘
  33.  SM4RA.EXE....:  Main executable program
  34.  SM4RA.CFG....:  Sample configuration file
  35.  SM4RA.DAT....:  Program file called upon by the program
  36.  SM4RA.DOC....:  Documentaion file (You're reading it right now!)
  37.  FILE_ID.DIZ..:  File Description
  38.  
  39. ┌───────────────────────────────────────────────────────────────────────────┐
  40. │ ▒▒ System Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  41. └───────────────────────────────────────────────────────────────────────────┘
  42.  Umm, a computer!  A RemoteAccess Bbs, and a multitasking environment such
  43.  as DesQview, Windows, OS/2, or Win95.  SM4RA has NOT been tested in any
  44.  network environment.  If you are running it in this environment, I'd like
  45.  to know about it.
  46.  
  47. ┌───────────────────────────────────────────────────────────────────────────┐
  48. │ ▒▒ How does it Work? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  49. └───────────────────────────────────────────────────────────────────────────┘
  50.  SM4RA simply accepts up to 10 lines of input from the SysOp.  Be careful to
  51.  NOT go over the maximum length of each line.  Then it will ask you which
  52.  node you wish to send the message to, or abort all together.  Once you have
  53.  told SM4RA which node to send the message to, it will then write the
  54.  contents of your input to the appropriate NODE#.RA file and place it in
  55.  your semaphore directory.  RemoteAccess scans this directory constantly and
  56.  checks for the existance of semaphore files and takes action accordingly 
  57.  based on the filename.  NODE#.RA simply tells RemoteAccess to display the 
  58.  contents of this file to the user currently on the specified node.  After it 
  59.  is displayed to the user, RemoteAccess will 'clean-up' the semaphore files
  60.  afterwards, so you don't have to worry about 'junk' files lying around
  61.  your HardDrive.
  62.  
  63. ┌───────────────────────────────────────────────────────────────────────────┐
  64. │ ▒▒ How to set up SM4RA ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  65. └───────────────────────────────────────────────────────────────────────────┘
  66.  Unarchive the contents of SM4RAV10.ZIP into any directory of your choice.
  67.  Using your favorite text editor, edit the sample SM4RA.CFG file.  NOTE: The
  68.  config file MUST be named SM4RA.CFG!  Line 1 should contain the path to 
  69.  your RemoteAccess semaphore files directory.  ie: C:\RA\SEM - - NOTE:  DO 
  70.  NOT INCLUDE THE TRAILING "\" BACKSLASH!  Line 2 will contain simply a "Y"
  71.  or a "N".  If you would like for SM4RA to append a 'wait for enter' key to
  72.  the message then set line 2 to "Y", if you do NOT want SM4RA to append the
  73.  'wait for enter' key, set line 2 to "N".  If you have RACONFIG.SYSTEM.AFTER
  74.  MSGS.> set to 0, then you will NOT need SM4RA to append the message with
  75.  the 'wait enter' key and you should set line 2 to "N".  If it (AFTER MSGS)
  76.  is set to anything else, then you should set line 2 to "Y".  You must also
  77.  set RACONFIG.OPTIONS.SYSTEM.MULTI NODE.> to YES, even if you are only
  78.  running a single node BBS!  Next simply set up SM4RA to be called from
  79.  another window from within your multitasker and you're ready to go!
  80.  
  81. ┌───────────────────────────────────────────────────────────────────────────┐
  82. │ ▒▒ How to Run SM4RA ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  83. └───────────────────────────────────────────────────────────────────────────┘
  84.  Once you have SM4RA unarchived to it's final resting place and have the
  85.  config file setup, you will need a way to run SM4RA.  I multitask my Bbs
  86.  through DesQview, and accomplished this by simply adding another DV window
  87.  and having it call the SM4RA.EXE file.  Under Advanced Options, I have this
  88.  window setup to close on exit.  This way, I simply open the SM4RA window
  89.  with it's two-key hotkeys, type my message in, send it to node 1 and the
  90.  program will exit and the window will close!  No batch file is needed!  It
  91.  can also be run straight from the DOS command line as well.  Once SM4RA has
  92.  been executed, you will be able to input up to 10 lines of text to send to
  93.  the user.  (If you need more than this, you probably should be actually
  94.  chatting with the user!)  Do NOT wrap each line over as this could cause
  95.  unpredictable results to the output file.  A blank line will stop the
  96.  editor and display to you your proposed message.  You will then be given
  97.  a choice to send this message to node 1, 2, or 3 or Quit the program and
  98.  abort the message all together.  The choice box is manipulated with the
  99.  arrow keys.  The Hotkeys "1", "2" and "3" are also available for nodes 1-3,
  100.  and Hotkey "Q" OR [Esc] key to quit the program and abort the message.
  101.  
  102. ┌───────────────────────────────────────────────────────────────────────────┐
  103. │ ▒▒ Why SM4RA? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  104. └───────────────────────────────────────────────────────────────────────────┘
  105.  I originally went shopping around for a program to do just this and found
  106.  a few good ones out there.  HOWEVER, they did MORE than I needed and/or had
  107.  unregistered notices (which I cannot stand!).  SM4RA started out as a batch
  108.  file and a couple of ansis with my favorite editor.  Then it became a past
  109.  time trying to actually code a program to do what my batch file was doing.
  110.  As it turns out, I should have stuck with the batch files <BG>.  Actaully,
  111.  I had lots of fun codeing this little program and have future hopes for it
  112.  as(if) my programming skills mature.
  113.  
  114. ┌───────────────────────────────────────────────────────────────────────────┐
  115. │ ▒▒ Credits/Acknowledgments ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  116. └───────────────────────────────────────────────────────────────────────────┘
  117.  I would like to thank Robert Parker of The Hut 2 @FidoNet 1:19/51 for all
  118.  his help during the codeing of this program.  Whenever I got stumped, or
  119.  decided I wanted something more than just what I had already, Robert was
  120.  there to help me out!  Thanks Bear!  I would also like to thank my wife
  121.  for putting up with me sitting on this thing for hours on end!  She had
  122.  some nice input for the program as well!  I would also like to thank the
  123.  following SysOps for their beta testing of SM4RA:
  124.  
  125.               Bob Lantrip    IRONSIDES BBS    @FidoNet 1:19/131
  126.               Rich Andes     Dragon's Den     @FidoNet 1:19/97
  127.               Homer Parker   Homer's Hut      @FidoNet 1:299/120
  128.  
  129.  Suggestions, comments, or bug reports should be sent to Joe Hornback,
  130.  Tornado Alley BBS @FidoNet 1:19/57.  Or, call and log onto a WELL-TWEEKED
  131.  RA Bbs at 405-657-3976.  The latest version of SM4RA will ALWAYS be
  132.  available for d/l direct from the Files Menu w/o having to dig through
  133.  file areas!
  134.  
  135.  Happy RAing...
  136.  
  137.  - EOF -
  138.